> ## Documentation Index
> Fetch the complete documentation index at: https://sequence-0fb8d9e6-api_docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Authenticating Users
> Documentation for Unreal SDK API to manage sessions for the Sequence infrastructure stack for web3 gaming.
The examples below apply to versions 2.x.x.
If you’re using version 3, use the SequenceEmbeddedWalletBP (Blueprints) and SequenceEmbeddedWallet (C++) classes instead.
## Requirements
* Make sure you have enabled your required login methods on [Sequence Builder](https://sequence.build/)
* Visit our [Platform Requirements](/sdk/unreal/advanced/platforms) page for detailed information on setting up and ensuring
that the authentication methods you choose are properly configured in your Unreal project.
## Start Email Login
Sign in users with any email, and they will receive a one-time password in their inbox.
Listen for the Email Requires Code event.
```cpp theme={null}
const TFunction OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartEmailLogin(Email, OnApiSuccess, OnApiFailure);
```
## Confirm Email Login with Code
Sign in users with any email, and they will receive a one-time password in their inbox.
Listen for the Email Requires Code event.
```cpp theme={null}
const FString Code = "123456";
const TFunction OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->ConfirmEmailLoginWithCode(Code, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
## Sign In as a Guest
You can sign in users as guests. However, note that they will lose access to their wallet if they uninstall the app or sign out.
Leverage our [account federation feature](/sdk/unreal/wallets/embedded-wallet/onboarding/authentication#account-federation) to link the wallet to another email or social account to keep access.
```cpp theme={null}
const TFunction OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartGuestSession(OnApiSuccess, OnApiFailure);
```
## Social Sign In
To initiate SSO-based authentication on desktop, you need to navigate to a browser to obtain the necessary id\_token.
On mobile, our SDK handles this process for you using integrated plugins.
On desktop platforms, listen for the `Sign in Web View Required` event and open the returned `Sign In URL`.
On mobile platforms, listen for the `Id Token Received` event.
When you call the `Sign In` functions, listen for the `Session Established` event on the `SequenceSessionsBP` subsystem
to know when the sign in request was successful. Listen for `Session Creation Failure` when something went wrong.
### Get Google Id Token
```cpp theme={null}
USequenceSessions* Sessions = NewObject();
if (Sessions->IsBrowserRequired)
const FString Url = this->Sessions->GetGoogleSignInUrl();
else
Sessions->GetGoogleTokenId(this);
```
### Get Apple Id Token
```cpp theme={null}
USequenceSessions* Sessions = NewObject();
if (Sessions->IsBrowserRequired)
const FString Url = this->Sessions->GetAppleSignInUrl();
else
Sessions->GetAppleTokenId(this);
```
### Sign In with Google
Sign In with a valid Google Id Token. You get this from the [Get Google Id Token](/sdk/unreal/wallets/embedded-wallet/onboarding/authentication#get-google-id-token) node.
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### Sign In with Apple
Sign In with a valid Apple Id Token. You get this from the [Get Apple Id Token](/sdk/unreal/wallets/embedded-wallet/onboarding/authentication#get-apple-id-token) node.
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### Sign In with Epic
Sign In with a valid Epic Games Id Token. Checkout the [EOS Plugin for Unreal](https://dev.epicgames.com/documentation/en-us/unreal-engine/online-subsystem-eos-plugin-in-unreal-engine)
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### Start Session with OIDC Id Token
Use this method to start a session using a valid Id token from Google, Apple or Epic Games.
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
## PlayFab
You will need to include your PlayFab Title ID in the `SequenceConfig.ini` file
during [Configuration](/sdk/unreal/wallets/embedded-wallet/setup) and [configure PlayFab in the Builder](/solutions/builder/embedded-wallet/playfab-configuration).
### PlayFab Registration
```cpp theme={null}
const TFunction OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->PlayFabRegistration(UsernameIn, EmailIn, PasswordIn, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### PlayFab Login
```cpp theme={null}
const TFunction OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->PlayFabLogin(UsernameIn, PasswordIn, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### PlayFab Authenticate with Session Ticket
```cpp theme={null}
const TFunction OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->PlayFabAuthenticateWithSessionTicket(SessionTicket, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
## Account Federation
To link another account to your wallet, simply re-use the same authentication methods.
The SDK will check if [there's an existing session stored](/sdk/unreal/wallets/embedded-wallet/onboarding/manage_sessions#check-existing-session) and will
automatically attempt to link that account.